home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / utime.z / utime
Encoding:
Text File  |  2001-04-17  |  8.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. uuuuttttiiiimmmmeeee((((2222))))                                                              uuuuttttiiiimmmmeeee((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _uuuu_tttt_iiii_mmmm_eeee - set file access and modification times
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_tttt_iiii_mmmm_eeee_...._hhhh_>>>>
  14.  
  15.      _iiii_nnnn_tttt _uuuu_tttt_iiii_mmmm_eeee_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_pppp_aaaa_tttt_hhhh_,,,, _cccc_oooo_nnnn_ssss_tttt _ssss_tttt_rrrr_uuuu_cccc_tttt _uuuu_tttt_iiii_mmmm_bbbb_uuuu_ffff _****_tttt_iiii_mmmm_eeee_ssss_))))_;;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _p_a_t_h points to a path name naming a file.  _uuuu_tttt_iiii_mmmm_eeee sets the access and
  19.      modification times of the named file.
  20.  
  21.      If _t_i_m_e_s is _NNNN_UUUU_LLLL_LLLL, the access and modification times of the file are set
  22.      to the current time.  A process must be the owner of the file or have
  23.      write permission to use _uuuu_tttt_iiii_mmmm_eeee in this manner.
  24.  
  25.      If _t_i_m_e_s is not _NNNN_UUUU_LLLL_LLLL_,,,, _t_i_m_e_s is interpreted as a pointer to a _uuuu_tttt_iiii_mmmm_bbbb_uuuu_ffff
  26.      structure (defined in _uuuu_tttt_iiii_mmmm_eeee_...._hhhh) and the access and modification times are
  27.      set to the values contained in the designated structure.  Only the owner
  28.      of the file may use _uuuu_tttt_iiii_mmmm_eeee this way.
  29.  
  30.      The times in the following structure are measured in seconds since
  31.      00:00:00 UTC, Jan. 1, 1970.
  32.  
  33.           _ssss_tttt_rrrr_uuuu_cccc_tttt    _uuuu_tttt_iiii_mmmm_bbbb_uuuu_ffff        _{{{{
  34.                _tttt_iiii_mmmm_eeee______tttt      _aaaa_cccc_tttt_iiii_mmmm_eeee_;;;; _////_**** _aaaa_cccc_cccc_eeee_ssss_ssss _tttt_iiii_mmmm_eeee _****_////
  35.                _tttt_iiii_mmmm_eeee______tttt      _mmmm_oooo_dddd_tttt_iiii_mmmm_eeee_;;;;_////_**** _mmmm_oooo_dddd_iiii_ffff_iiii_cccc_aaaa_tttt_iiii_oooo_nnnn _tttt_iiii_mmmm_eeee _****_////
  36.           _}}}}_;;;;
  37.  
  38.      _uuuu_tttt_iiii_mmmm_eeee also causes the time of the last file status change (_ssss_tttt______cccc_tttt_iiii_mmmm_eeee) to
  39.      be updated.
  40.  
  41.      _uuuu_tttt_iiii_mmmm_eeee will fail if one or more of the following are true:
  42.  
  43.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Search permission is denied by a component of the
  44.                          _p_a_t_h prefix.
  45.  
  46.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Write permission on the file named by _p_a_t_h is denied.
  47.  
  48.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              The effective user ID is not the owner of the file,
  49.                          _t_i_m_e_s is _NNNN_UUUU_LLLL_LLLL, and write access is denied.
  50.  
  51.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT              _t_i_m_e_s is not _NNNN_UUUU_LLLL_LLLL and points outside the process's
  52.                          allocated address space.
  53.  
  54.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT              _p_a_t_h points outside the process's allocated address
  55.                          space.
  56.  
  57.      _EEEE_IIII_NNNN_TTTT_RRRR               A signal was caught during the _uuuu_tttt_iiii_mmmm_eeee system call.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. uuuuttttiiiimmmmeeee((((2222))))                                                              uuuuttttiiiimmmmeeee((((2222))))
  71.  
  72.  
  73.  
  74.      _EEEE_LLLL_OOOO_OOOO_PPPP               Too many symbolic links were encountered in
  75.                          translating _p_a_t_h.
  76.  
  77.      _EEEE_MMMM_UUUU_LLLL_TTTT_IIII_HHHH_OOOO_PPPP           Components of _p_a_t_h require hopping to multiple remote
  78.                          machines and the file system does not allow it.
  79.  
  80.      _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG        The length of the _p_a_t_h argument exceeds {_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX},
  81.                          or the length of a _p_a_t_h component exceeds {_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX}
  82.                          while ______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC is in effect.
  83.  
  84.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT              The named file does not exist or is a null pathname.
  85.  
  86.      _EEEE_NNNN_OOOO_LLLL_IIII_NNNN_KKKK             _p_a_t_h points to a remote machine and the link to that
  87.                          machine is no longer active.
  88.  
  89.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR             A component of the _p_a_t_h prefix is not a directory.
  90.  
  91.      _EEEE_PPPP_EEEE_RRRR_MMMM               The calling process does not have the super-user
  92.                          privilege, the effective user ID is not the owner of
  93.                          the file, and _t_i_m_e_s is not _NNNN_UUUU_LLLL_LLLL.
  94.  
  95.      _EEEE_PPPP_EEEE_RRRR_MMMM               The calling process does not have the super-user
  96.                          privilege, the effective user ID is not the owner of
  97.                          the file, _t_i_m_e_s is _NNNN_UUUU_LLLL_LLLL, and write permission on the
  98.                          file named by _p_a_t_h is denied.
  99.  
  100.      _EEEE_RRRR_OOOO_FFFF_SSSS               The file system containing the file is mounted read-
  101.                          only.
  102.  
  103.      _EEEE_RRRR_OOOO_FFFF_SSSS               The current file system level range does not envelop
  104.                          the level of the file named by _p_a_t_h, and the calling
  105.                          process does not have the super-user privilege.
  106.  
  107.      _EEEE_NNNN_OOOO_SSSS_YYYY_SSSS              When the named file cannot have its time reset.  The
  108.                          file is on a file system that doesn't have this
  109.                          operation.  Example, the /dev/fd/0 file is on a file
  110.                          system that doesn't allow the time to be reset.
  111.  
  112. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.      _ssss_tttt_aaaa_tttt(2), _uuuu_tttt_iiii_mmmm_eeee_tttt_ssss(2)
  114.  
  115. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  116.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  117.      of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.